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ABSTR ACT 

Recognizing that the use of resource sharing 
capabilities provided by computer networks is inhibited by rhe 
requirement that the user become familiar with the vaiied command 
languages and protocols of each accessed system, this report presents 
a general approach to solving the protlem using an intermediary 
system to support a set of coimon commands for file manipulation and 
network job execution. Tested in an experiment with fcur different 
systems, this common command language permits the network, user to 
easily traa^fer files between varied systems cf the network and 
provides the capability tc execute programs at particular hosts using 
data that may not initially be available where the frcj^ram is to be 
executed- An account of the development and i mplementarl'on of rhe 
command language is followed ty a description of its usage in system 
interconnection, intrasystem file handling, intersystem file 
transporting, and network 1ob execution. An appendix provides a 
display of the conmand language and a list of pertinent references. 
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DISCLAIMER 



Certain commercial products are identified in this oaper 
in order to specify adequately the experimental procedure, 
or to cite relevant examples. In no case does such 
identification imply recommendation or endorsement by the 
National Bureau of Standards, nor does it imply that the 
oroducts or equipment identified are necessarily the best 
available for the purpose. 
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Common Command Language for Pile Manipulation 
and Network Job Executions An Example 

N. L. Fitzgerald 



Computer networks provide the capability for 
sharing resources across many diverse computer 
systems. Utilizing this capability is inhibited 
by the requirement that the user become familiar 
with all the varied command languages and proto-> 
cols of each accessed system. This report 
presents a general approach to solving this prob- 
lem using an intermediary system to support a set 
of Common Commands for File Manipulation and Net- 
'work Job Execution. To show the feasibility of 
this approach, common commands were implemented 
for four systems using the UBS Network Access 
Machine. 

Key words: Command language; Computer networks; 
Network access; Macros. 
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X* INTROOUCTION 



Computer networks h«v« Made available to thm pro9ra«- 
ain9 comnunlty tha sarvicas and raaourcas of many typaa of 
coaputar ays teas, unfortunately, aacb of thaaa ayataas toaa 
its own, soaatiaas coaplax, language and aetbodology for ac- 
ceaaing its lesources. A network user la faced with the 
taaf of becoaing faailiar with the specific coaaand language 
for each systea before using the services available on that 
systea. 

One method for siaplifying the usage of conputer net- 
works might be to develop a set of standarda for network ac- 
cess INBS 7?1 iNfiU 75]. The vendors of coaputer services 
would oe required to aaXe their products compatible with 
these standards if the services were to be available to the 
networking community, in the absence of sucn a standard, a 
ditiietent method is required. 

An alternative approacn to eimplifying networking for 
users is to develop a standard language to which the diverse 
sets of commands for heterogeneous hosts can be translated. 
I'hia language should provide a comwon set of commands to 
gain access to the computer systems on the network, and to 
manipulate filea on those systems. Since the network user 
is concerned with many different systems, the language 
should present a uniform view of the ayatema through the 
standard commands and also remove many of the compleaities 
of inter-system interactions. Therefore the language ahould 
permit the network user to easily transfer files between 
different systems of the network and provide the capability 
to execute programs at particular hosts using data that may 
not initially be available where the program is to be exe- 
cuted. 

In order to show the feasibility of such a language, an 
experiment was performed in which common commands were 
developed for the following four systems x a Honeywell 6180 
running MULTICS, a PDP-lkJ running TOPS-IB, a PDP-HJ running 
TfaNEX, and a PDi>-li/45 running UNIX. The language was im- 
plemented on a PDP-li/45 under the UNIX operating system v.a- 
ing the NetworK Access rtacnine IROS 76] as its foundation. 
Expanding the l.inguage to include other systems is very 
straightforward and requires little programming effort. 



II. OSVfiLOPNfiNT OF TUB COMMON COMMAND LANQUAGS ^ 



development of tho Coamon CoaitaiKl Languago iCCL) 
started by deteraining soae of tlie desired properties of a 
coMon cowiand language* Neit* a survey of tde existing 
Goaaand lan'^'^mges of the systems in the esperisent was made 
to define the required coaaands. The CCL was designed as an 
atteapt to provide a viable language for network users of 
those systeas. 



II.l. C0/4NAN0 LANGUAGfid 



The priaary concern of aost coaputer or network users 
is to get a job don«, ideally as siaply as porsible. Usual- 
ly, the user has little or no interest in the various pecu* 
liarities of the different systeas to be used. This in- 
cludes differences in the syntax and seaantics of the coa* 
aand languages of those systeas. The user should also be 
shielded froa dealing with the coaplexitles of error aes- 
sages which aay occur during a terainal session. 

At best, then, the language provided to a network user 
should allow aaxiaua access to the features of all the sys- 
tems available with mininum system dependent interaction. 
In addition, it must supply a reasonable cross-section of 
all the available Ss^rvic^s each system maintains, but it may 
not necessarily handle commands dependent upon the physical 
properties of the system due to differences in hardware con- 
figurations and equipment. 

extensive study has been made to determine the moftt 
desired properties of a common command language (UMG 74J. 
The properties should include the following! 



Obvious The commands shoul'^ pertotm 



the actions their names imply. 



Simple 



Th€ coiniBands should be simple 
in format and machine indepen- 
dent. 



Uniform 



The functions performed should 
be equally adaptable to all 
systems involved. 



Transparent 



The user should be unaware of 
any system peculiarities and 
shielded from different types 



of •rcor or systM aossagos. 



Extendable 



The coaaand repettolre should 
be easily extended to add .nore 
comands if necessary. 



In order to develop the CCL the following three steps were 
taken s 

1. A survey of the systens to be used was nade to 
determine all the different types of (logical) 
file handling functions available. These func- 
tions deal with the files themselves as named en*- 
tities, rather than with the contents of the 
files* 

2. The coiuBand names for the functions were 
Chosen, trying to maintain an intuitively mean- 
ingful vocabulary. 

3. The commands were implemented on the hetworii 
Access Machine. 

II. 1.1. command Survey. 

Four types of computer systems were used for the 
development of the CCL. In order to select the commands to 
be implemented, a survey of the file manipulation commands 
of each of these systems was made, and for each different 
function represented, a common command was implemented. 

Table II. 1 indicates the types of file manipulation 
functiciis that are commonly available and the corresponding 
commands for the systems being surveyed. Dashes in the 
table indicate that the system does not have a command for 
the described function. (In some cased there may be a utili- 
ty that can be invoked on a given system, but not a single 
command . ) 

These comman is are for logical manipulations on files 
as entities wituin an operating system. Functions which use 
the other resources of the operating system such as editors 
will not be addressed at this time. Later this language 
will oe incorporated with other functions to provide the 
capabilities of a Network Operating System (NOS) IKIM 76-ij 
lAiM 7t)-2i. Tne NOS environment will provide the user with 
tne ahiiity to use a network in the same manner that ne 
would use a single system, included within the uon will he 
a wetwork wide uirectory system that will descr.^be the user, 
the user's tiles on the network, the configurations and 
structure of the various hosts on the network, and the 
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lnt«r«ctlonft peraltttd aaong thea. In addition th; HQS will 
provide function! for roaoto record access and data transla-> 
tion and transforMation (WOOD 78]. 
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functions multics tbnsx tops^xm unix 



append one ' 
file to another 


I 


j append 


1 


1 cat 


A 


coapare two 
files 


i coapare 




1 ™ 


j cap 


y 
« 


make a new 

file 


1 create 


1... 


1 alcfil 




« 


remove file nane 
from directory 




i delete 


1 


I"" 




restore file to 
directory 


!"' 


1 undelete 


1 


j... 




renove file fron 
directory 


i delete 


j expun9C 


1 delete 


1 ra 




make copy of 
& file 


1 copy 


i copy 


1 copy 


1 CP 




obtain directory 
listing 


i Is 


) dir 


1 dir 


1 Is 




list contents of 
a file 


1 pr 


1 type 


i type 


1 cat 




change tne name 
of a file 


i rename 


( rename 


i rename 


i mv 





H.1.2* Yhe Coanon Coiuiand Lan^uago Structure* 



The CCL consists of four aajor coHUnand types i Intra- 
system commands. Inter-system commands, network job execu-^ 
tion commands, and system inter-connection commands. 



Xntra-system Commands 

i»ince each of the functions described in Table XX •! is 
available on at least one of the systems, it was decided 
that the CCL would contain a command for each of the func- 
tions represented. The names were chosen trying to maintain 
a correspondence between the functions performed and the 
command. Xn addition, some of the command names were chosen 
in Keeping with some of the currently available commands. 



append 

compare 

copy 

create 
delete 

erase 
list 

rename 
type 

undelete 



append one file to another 

compare one file to anothe;.. 

!»aKe a copy of an existing 
file 

make a new file 

remove the file name from the 
user 's directory 

remove filf completely 

Jist the names of the user's 
files 

change the name of a file 

display the contents of a text 
file to the user terminal 

return £i deleted file name to 
the user's directory 



Xnter-system Commands 

Along with the commands for file handling listed above, 
the language contains commands to transfer files between 
systems. « 



retrieve 



move file from remote host to 
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j2 



prljiaxy host 

transfer move file from primary host to 

a remote host 



by stem Interconnection Commands 

Before a user can actually perform any file manipula- 
tions, access must be gained to the syst«tm where the files 
reside. The command language therefore contains commands to 
connect the user to a remote system and execute the particu- 
lar login procedure required. Likewise* when the terminal 
session is over# there exist commands that will log the user 
out and terminate the connection. 



Network Job Execution 

Often, a network user may want to execute a program on 
a specific host and the desired data files reside on other 
hostiT throughout the network. Ideally the user would like 
to be able to specify jus^ one command that could indicate 
wnere the program is to be executed, where the input data 
reside, and where the output data should be sent. Such a 
command could have the format: 



kUN i»KU>KAM«tiOi>Ti^HOST2 lNl«INFIL£lidti(Ji>TA UUa'i»OUXif^ILl:;li?iiUSTa 



where 



PMOGRAM - 
ijOSTl 
fi!0ST2 
INI 

INPILEl - 
HOST A 
OUTl 

OUTFILEl- 
aOSTB 



program name 

where program is to be <»xecuted 
where progrcan resides 
program's name for input file 1 
actual name for input file 1 
where input file 1 resides 
program's name for output file 1 
actual name for output file X 
whare output file will be migrated 



One of these commands would constitute a network job 
step and a sequence of network job steps could be Known as a 
network io«->. 
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In ord«r to •x«cut« • network job an. additional coaaand 
calitd 'run' ia alao part oC the co»an^ rapactoire. Thia 
coaaand ia uniqua bacauaa ita actiona ara dictatad by the 
uaar through two utility prograaa which ara callad to dafine 
tha natwork job to ba run. 



II .2, IMPLSMSNTATlbN 



Tha iapleaantation o£ the CCL waa facilitated by utili- 
zation of the NbS Network Acceaa Machine (NAM) which pro- 
videa tha cooaunication aupport for thia atudy lAOS 7aj . 
The NAM ia a prograa that runs under the UNIX tiaeaharing 
ayatea on a I^DP-ll/ib. Through thia prograa the user at an 
interactive terainal aay eatabliah connections with aany 
types of r^nvta coaputers. The NAM providea directives that 
p«rait the user to aaintain a dialogue with the ayateaa of a 
network. Sequences of these directivea atored in filea 
called aacroa have been written that will generate the 
necessary aachine-dependeni dialog to perfora the file aani- 
pulation functiona required for each of the boat ayateaa. 
The responses generated by the reaote aysteas are in turn 
analysed by the NAM. By peraitting the aapping of the 
variad aystea responses into standardized aessages for the 
network user to see« the NAM facilitates the uniforaity of 
the CCL. 

The comaands of the CCL were iapleaented aa a set of 
aiaply naaed NAM aacros , Since each aystea requires a 
unique dialogue to perfora a given function # a aacro to gen- 
erate that dialogue is needed for each aystea. Thus, the 
renaae coousand is really iapleaented as several aacros naaed 
'renaae', one for each of the systeas in the study. The 
particular aacro that is called depends upon which system 
the user is connected to. Incorporating a new system type 
merely involves adding a set of command macros for that sys- 
tem. 

figure Ii.2.1. shows two such macros for the renaae 
command: one for a TOJ?S-i0 system and one for a UNIX system. 
The TOPS-IU command to perform the file renaming function is 
'rename' and provides one of three different responses to 
the user t 

1) "File X already exists" if there already is a file 
with the new name. 

2) "File renamedi" if the renaae was successful and 

3) "? NO file named x" if the file to be renam*»d 
doesn't exist. 



Macro for th« coaaand RSNAMS for a TOPS-* 18 ays tea. 



.tara "tas I 

•aatch "'.'1 'altaady axiata' i 'No file'" topalt 

• send "renaaa "$2" « '*$1'*[CR1'* 
*awitch aatchad 

*caa€ 3s 

.aag "File "$1" not found. (CR] (LFJ " 
•break 

*ca8e 1{ 

.aag "Pile "$1** renaaed to ''$2«. (CR] (LP] " 
•break 

*ca8e 2: 

•sag "File "$2" already exists^ (CR] (LF] " 

*end 
•flush 

• exit 



Macro for the coaaand REt^AME for a UNIX aystea^. 



•tera "t30 i '%'" 

•match "'not found' 1 'not exist' i '%'" unix 
•send "Is "$2"ICR1" 
*if matched • 1 

•send "mv "$1" $2"{CRJ " 
*if matched » 2 

.msg "File "$1" not founds (CR J (LFJ " 

•flush 

.exit 

*end 

•Bsg "File "$1" renamed to "$2" • ICR] (LFJ " 

• flush 

• exit 

♦else 

•msg "File "$2" already exists^ (CRJ (LFT' 

• flush 

• exit 

*end 



Figure II^2^^ Sample macros^ 
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Tti«!cefoc«» tne ranAA* nacro cust send the TOPS-li cenaa* 
coanano to th« tysteii and analyse tna lystaa raAponna. Ua* 
in9 the mam stateaentt 'switch' and 'case', the aacro out- 
puts an appropriate aessage Cor the resulting, systea 
response. 

On UNIX systeas* however* renaaing files is accoa- 
plished through the 'av' coaaand and existing files with the 
new naae will be overwritten without warning the user. 
Therefore, the renaae aacro for UNIX first deteraines if a 
file with the new naae exists. If not, the 'av coaaand is 
sent to the systea and the response is analysed to deteraine 
if the renaae was successful. In this aacro, the NAM state-* 
ments of 'if and 'else' are used to differentiate a«iong the 
possible systea responses. 

This ability of the NAM to analyse systea respbnses, 
provides the aechanisa to standardise aessages that the CCL 
user sees, each of the systeas in the above exaaple haS 
different responses for non-existent files, yet the aessage 
the user will see will always be "File x not found" if the 
file to be renamed does not exist. Moreover, since the use 
of NAM macros permits multiple NAM-reaote systea interac- 
tions for one user command, the command level capabilities 
for the systems appears to be extended. 
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III. COMMON COMMAND LANGUAGE USAGE 



This section describes ^he usage of the conunands of the 
CCL. Each of the four types of commands is covered and a 
example of its usage is given. * 



XII. 1. SYSTEM INIfilRCONNECTION COMMANDS 



In order to perform any file manipulations on a specif'* 
ic host via a network, a user must gain access to that host 
and execute a successful login procedure. Two types of con- 
nections can be made by the network users primary connec- 
tions which connect him to the host where most of the ses- 
sion will occur; and secondary connections which are used to 
allow file transfers between different hosts. For this 
study, most of the systems were primarily available through 
the AKPA network. biiN refers to the host ii&N-TENeX, while 
ISI is the USC-ISI TENEX system. NbS-lii and UNIX45I refer 
to hosts within the NBS Experimental Computer Facility and 
MULTICS is the MIT-MULTICS. (In addition, the language was 
expanded to include the UNIX41S3 machine at NBS and the Mul- 
tics system at the Rome Air Development Center.) 



III.I.l. Establish Primary Connections. 

The following commands make and break primary connec- 
tions on the systems he user wishes to access. A primary 
connection is made to t le system the user expects will be 
utilized most during the session at the terminal. These 
commands are identified by the names of the systems to be 
accessec* 



bDN <ldentifter> 
Ibl <ldentifiet> 



A user enters this command to 
establish a primary connection 
with the TENEX systems at btiN 
or ISI. The identifier is the 
user's name as known to the 
system and the user will be 
interactively , requested to 
supply password and ctccounting 
information. 



MULTICS <Identif ier 



A user enters tnis command to 
estabish a primary connection 
with MULTICS at MIT. The 



identifier is the name of the 
user as known to the system # 
and again password information 
must be supplied as required. 



tikiHi^ <Ident.l£ier> 



This will establish a primary 
connection with the hBS POP-*ltf 
system running TUPS-ltf* The 
identifier is the user's 
project*prog rammer number on 
the 10 and password informs* 
tion is requested. 



UNIX451 <Identi£ier> 



The command establishes a pri- 
mary connection with a 
POP'>ll/45 running UNIX. The 
user will be connected to and 
logged onto the UNIX451 system 
at NBS. A password will be 
requested. 



III»1.2« Establish Secondary Connections. 

Secondary connections are made when the user wishes to 
transport files to or from a host other than the primary 
connection. These commands are the system name prefixed by 
'conn' or 'leave' depending on whether the user is connect- 
ing to or disconnecting from the system. 



CONMUtiM 
CUMMISI 



<ldentif ier> 
<identif ier> 



A secondary connection is es- 
tablit^ned with a Hiint^X, system 
at bBN or ISI. The identifier 
to be supplied is the name of 
the user Known to the system. 
The password and accounting 
information must be supplied 
by the user. 



C01.NMULTICS <ldentifier> 



A secondary connection is es- 
tablished at NULTICS. Again 
the system will request a 
password which the user must 
supply. 



CONNNBSlii <Identifier> 



A secondary connection is made 
with the NBS PDP-lkJ running 



-li- . 



TOPS-10* Ttit id«nti£l«r is 
the project<-progcawi«c nuaber 
of the ut «r at NfiS and the 
systea will request a pass- 
word* 



C0NNUMIX4S1 <Identi£ier> The coaisand establishes a sec-> 

ondary connection with the 
UMIX451 systes at KBS. Login 
cosmands are issued using the 
user's identifying naae speci- 
fied in the identifier parane* 
ter. The system again will 
require the user to enter a 
password. 



ill « 1.3. jierxninate Friiaary Connections. 



LbAVb This is the coanand issued to 

terainate coaaunications with 
any of the four priaary con- 
nections* The NAM is aware of 
which systea the user has es- 
tablished as the priaary con- 
nection and will execute this 
coaaand to log the user out 
froa that host and terainate 
the connection. 



Ill .1.4. Terainate Secondary Connections. 



L£»AVehost This is the coaaand used to 

close out the secondary con- 
nections. The host part of 
the coaaand can be either BBU, 
ISl, MULTICS, NaS10 or 
UNIX451. The coaaand logs the 
users off the secondary host 
and closes the connection with 
the MAM. 
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III. 2. THB FILE HANDLING COMMANDS (Intrasystea) 



The following is a description of each of the file 
manipulation comaands, their usage and parameters. 



FILtil 18 appended to FILis;2. 
If FILiSl does not exist, the 
message "File FILtl not 
found." is given and FILb2 is 
unchanged. If FILfi2 does not 
exist, a copy of FILiii is made 
and called FILiui. 



COHPAK£ FIL£1 FILiu2 



If either FILEl or FILB2 does 
not exist a message is given. 
Otherwise the character files 
are compared on a line by line 
basis and a message indicating 
whether they are different or 
equivalent is issued. (Com- 
parison of non-character files 
will be a future option of 
this command.) 



COPY FlLbl FILbi 



A file called FILfi2 is created 
that is a copy of the file 
called FILE!. If there al- 
ready exists a file called 
FILfc.2, it is NOT overwritten 
and a message indicating tnat 
FiLE2 already exists is given, 
if FILLI does not exist the 
message "File FILfil not 
found." is output to the 
user's terminal. 



C HE ATE FILEl 



The directory entry for file 
FILE! is made. If there al- 
ready is an entry by that 
name, the message "File FILE! 
already exists." is given. 



DELETE FlLEl 



File FILEl is removed from the 
user's directory. This im- 
plies that the user may no 
longer access that fils and 



■«y aven crtatc another file 
with the SMie naae* tiow«ver» 
the file itself still exists 
and nay be undeleted (re- 
stored) at a later time* pro- 
vided that either the user 
does not logout or does not do 
an erase coaaand (see UNOKLBTfi 
and EBASfi.) If a file of the 
sane nana has previously been 
deleted* the nessage "Pile 
FIL£1 previously deleted." is 
given to pernit the user ac- 
cess to the previous version 
of the files. in this case 
either the previously deleted 
file nust be erased, or in 
case it is still useful, the 
nane of the current version of 
the file can be changed before 
it is deleted. If FXL£1 does 
not exist, a message **File not 
found." is given. 



The command completely removes 
any previously deleted files. 
Once an £.jiiAS£ is done no more 
UNL£L£T£;8 can be done on those 
files. In addition, an au- 
tomatic erase is done when a 
user leaves the system. 



LIST 



All the file names from the 
user's directory are listed in 
the format of the directory of 
the system being used. 



RENAME FILEl FILE2 



FILEl is renamed to f:le2. If 
there already is a FILe2, the 
message "File FILE2 already 
exists." is given and the 
fil^ retain their names. If 
there is no FILEl, the usee 
will be informed. 



'AXFE FILhl 



I'he convents of FiLEl are dis- 
piaye'i on the user's terminal. 
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UMOfiLfiT£ FILE! The co«»««d returns any pre- 

viously deleted file to the 
user's workspace* 



IH.3. INTBKSySTfiM FXLfi TKANSPOKTIKG COHHAHDS 



Tiie CCL extends the file handling capabilities of the 
nost computers studied by providing coounands that transfer 
files between systens. Thus the user enters system i«y** 
commands and has the ability to transfer and retrieve fU«« 
to and from remote hosts. In order to use these commands, 
the user must establish a primary connection with one host, 
and a secondary connection with the host with which the ex- 
change is to take place. In addition a directory listing 
capability for secondary connections is provided* 

LISThost The directory listing of the 

secondary host host is ob- 
tained. 



RBTRIEVE FILEl SECONOARYHOST A file named FILEl is sent to 

the primary host from the 
secondary host. It vVl be 
assumed at present that the 
file does indeed exist on the 
secondary host end a file of 
the same name does not as yet 
exist on the primary nost. 



•iiviiu;3iri.xv tiLLi SlCuwdAK^wuST The file flLEi is sent from 

the primary host to the secon- 
dary host. Again it is as- 
sumed that the file does exist 
on the primary host and a file 
of the same name does not ex- 
ist on the secondary host. 



ill .4. A SAMPLE s&aaioii 



In order to show the usage of the CCL, a scenario for a 
sanple terminal session will be given and the coamands used 
will he listed. 

A network user has accounts at MULTICS and the 
NBSltf. A primary connection is established with NULTICS and 
a listing of the files stored there is made. The files ares 
aul» nul2, and biu13. The user decides to combine mul and 
mul2 and just keep the combined file. In addition he de- 
cides to transfer this file to the NBSli as a backup copy. 
Therefore he appends mul to mul2 and deletea mul. A secon- 
dary connection is made with the NBS10, a directory listing 
is requested, and the nev mul 2 is transferred there. ae 
finds that in a previous session he made a file on the NBS10 
that should have been a copy of the old mul file, but he is 
not sure. He retrieves that file, mul, from the NBS10 but 
cannot compare it with the old mul because he deleted it a 
few moments ago. Also, since the file he retrieved from the 
NBS10 has the same name as tne deleted file, he cannot un- 
delete it yet. So, he renames the retrieved file to mulnbsl 
and then undeletes the old mul. Now he compares the two 
files and since they are different, deletes them both, tie 
is now finished and so terminates the secondary connection 
and then terminates the primary connection. 

MULTICS IM ATKINS 
LIST 

APPEND MUL MUL2 
DCLSTiii MUL 
CONNNBS10 510/46 
LISTNBS10 

TRAHSP&R MUL2 NBS10 
K£TaiSV£ MUL NSS10 
I^ENAMB MUL MULNBSi 
UNDELETE MUL 
COMPARE MUL MULNBSl 
DELETE MUL 
DELETE MULNBSl 
LEAVENBS10 
LEAVE 



The following is a listing of the terminal session for 
this example. 



I ntm 

A T«st V«ciiion of th« MBS Network Accosa Nachino 
taultica Watkins 

Nnltica 33. 3t NIT, Caabriaga, Naaa. 

Load • 37. g out of 85. a unitat uaara » 37 

Paaaword t 

iliat 

Sagaanta » 9, Lang t ha • 6. 

■ul3 
IIU12 
quaan 

quaan.pll 

Natkina.abx 

atart_up.ec 

Watkina.prof ile 
watkins . con__in8g s 

r 1248.7 $ 

: append mul mal2 

Pile aul appended to aul2. 



tdelete aul 

File »ul deleted. 



tconnnbalS 510/46 

.JOB 22 NBS-10 5.07B NBS 5/IL TTY65 
ILGNNOC No operator coverage. 
Paasword s 

sliatnbalS aul 

MUL 1 <155> 2WU1-77 OSKBs (510, 46 J 



ttranafer «ul2 nbsl0 

File aul2 tranaf erred to nbal0. 



1 retrieve aul nb8l0 

File aul retrieved froa nbsl0. 



o 
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tr«fi«i« iiul sulnbsX 



t undelete aul 
Pile aul restored • 



scoapare ^cl ■ulnbsl 
Filer are different. 



sdelete nul 

File aul deleted. 



idelete aulnbsl 

File Bulnbsl deleted. 



tleavenbali 

connection nbsl0 closed 



t leave 

connection multics closed 
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IV « NF'tWORK JOB EXECUTION 

4 



This section describes the nethod of providing network 
job execution capabiJLities developed in conjunction with the 
CCL. 



IV.-i* COMMAND DESCRIPTION 



Inplenenting the KUN connand described in section 
II.1«4^ in the sane aanner as the other conmiuads of the 
language would be extreaely difficult and not within the 
format constraints of a NAM nacro call. In addition* re- 
^uirin^ the user to type in such a sequence of complex 
strings increases the liKelihood of error and diverges fro» 
the simplicity of commands demonstrated in the rest of the 
CCL. Therefore, two utility programs were developed for the 
NAM which, in conjunction with the CCL commands previously 
described, provide a means for the user to define a network 
job. 

The first utility is called MAKEPROFILB. It is an in- 
teractive program that queries the user for information 
about the various systems the user wishes to access. It re- 
quests the user names, passwords and account numbers for the 
systems to be used, and builds a data file called a 'pro- 
file' for the user which is used by the second utility . 

The second utility is called RUNMACRO. It also is an 
interactive program that asks the user to supply all the in- 
formation needed to specify a network job. For each job 
step in the network job, the user is asked to give the pro- 
gram name, host names, and all the rest of the data names as 
described above in section III. 1.2. After the user speci- 
fies all the steps, the program builds a NAM macro called 
'hulh' that is a sequence of all the CCL commands that are 
required to perform the transitions for each function to be 
executed. Using the profile, the program supplies all the 
accounting information required to make connections that the 
user usally has to supply interactively. After executing 
the runMaCRu utility, the user merely executes tUe RUN mac- 
ro, and the network job is executed. 



IV .2. COMMAND USAGfi 



Tit« foixowiny pfroc«cluc€ d«8cribtt« tbe steps a uses 
tsKes in ocdes to define a network job. 

1. L09 onto UNIX. 

2. &un< the NAM progias. 

3. fintec the accounts and passwords of the systeas to be 
used by running the 'maK£PROPILB' program, finter 'MAKfiPRO-* 
filk' in response to the prompt character and answer the 
queries. (Motet The identifier required for the NBS10 is 
the project-prograamet nunber pair separated by a slashs 
e.g., 510/46). 

4. define the sequence of job steps to be executed in Mie 
network job.. For each job step the user aust specify the 
name and residence of the program to be executed » where it 
is to be executed* vhich input files to transfer, and which 
output files to transfer by answering the queries of the 
'RUNMACRO' prograa. The output of this program is a NAM 
macro that will perform th^t desired functions. 

5. KnteT 

RUNHACRO 

m response to the prompt "i^nter Program specif icationst" 
the user enters 

ppro9(^nostli^host2 

where pptog . is the name of the program to be run, hostl is 
the name of the system where the program is to be executed » 
and hoat2 is the name of the system where the program is 
currently located if it is not already at hostl. If hostl 
is the same as ho6t2, enter 'pprogi^hostl ' . 

If there are no more job steps to be defined « the user 
enters a carriage return. 

The utility will then query the user for the logical names 
of the input files, that is, the names by which the program 
Knows the input files. Then the utility will ask for the 
actual names for the data files and the hosts at which they 
reside. If the file exists at the execution site, enter a 
carriage return in response to the host name. If there are 
no more input files, enter a carriage return in response to 
the file name. After obtaining the names of the input 
tiles, the names and sites for the output files will be 



obtained* using the saae philosophy for on toeing tho 
rosponsoo* 

6, Aftor oxocution of tho 'RUHMACRO' prograa, thoro exists s 
■scro called 'RUN' in tho user's directory. The user enters 
'run' and the macro will be executed. 



IV. 3. SAMPLfi NETWORK JOB EXECUTION PROCEDURE 



The user wishes to execute the program TEST on the 
NBSltf. The source for TEST resides on UNIX451. There are 
three input filesj FILEl located at BEN, FILE2 located at 
NBSlkt and fILB3 located at ISI. They are to be given the 
logical names INl, 1N2 and IN3 respectively. The program 
produces three output files* OUTl, 0UT2 and 0UT3. They are 
to be renamed to OATAl, PATA2 and UATA3 respectively and 
moved to other sites as followsi DATAl goes to UNIX451, 
LIATA2 goes to EBN and DATA3 will remain at the NBS10. There 
will be only one Network Job step in this , so only one set 
of specifications will be entered. (Notes The user a 
responses are to the right of the 't'. Responses for pasi- 
word entries for the MAKEPROFILE program are not echoed. 
All other entries that are not seen are responses of 
carriage'-return to indicate no response.) 

The following dialogue will transpire* 
%nam 

:iPakeprof lie 

Input Identifier at BBNisww 
Input Identifier at isi:sww 
Input Identifier at NBS10t510/46 
Input Identifier at UNIX451tfitz 
Input Password at BBNt 
Input Password at iSIt 
Input Password at NBS10} 
Input Password at UNIX451 : 
Input Account at BBN:333 
Input Account at lSI:4li) 
input Account at NBSltft 
Input Account at UNIX45i: 

xrunmacro 

bnter tTogram bpecif ications i Tfc;ST«NBSltfieUNlX451 
Kemote file access? (y or n) n 

Logical Name for input File Ix INl 
Actual Name for Input File It FILEl 
aObT 1 * BbN 

Logical Name for Input File 2: IN2 
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ActaaJl MMie foe Input film 2t Flli£2 
aosT 2 - 

Logical Maa« for Input File 3t IN3 
Actual tia«« Cor Input File 3 s FIL£3 
tiOST 3 - ISl 

Logical Maae for Input File 4t 
Logical Naae for Output File It OUTl 
Actual Name for Output File Is OATAl 
ttOST 1 • UNIX451 

Logical Naae for Output File 2s 0UT2 
Actual Naae for Output File2s 0ATA2 
liOST 2 - fiBN 

Logical Maae for Output File 3s 0UT3 
Actual Ma»e for Output File 3s 0ATA3 
OOST 3 - 
0UT4 » 

Enter Prograa Specif icationss 
srun 



The "RUN" nacro produced is the following. The user 
password supplied fro» the profile is indicated by <PASSWD>. 

NBSli 510/46 <fASSWO> 
UNIX451 FITZ <PASSMO> 
TRANSFER TBST NBS10 
LfiAV£:UNlX451 
C0KN68N SSMlM <PASSWD> 
KfiTKI£V£ FILfil 
LEAVE^BN 
KEnAME FILEl INI 
KENAME FILb2 IM2 
CONN IS I 

RETRIEVE FILL3 
LEAVEISI 

RENAME FILE 3 IN3 
TEST 

CONNUNIX451 FIT2 <PASSWD> 

RENAME OUTl DATAl 

TRANSFER DATAI UN 1X4 51 

LEAVEUNIX45I 

CONNBBN SMM <PASSMD> 

RENAME 0UT2 0ATA2 

TRANSFER DATA2 BBN 

LEAVE BBN 

RENAME 0UT3 0ATA3 

LEAVE 
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V. CONCLUSIONS 



The Common Conmand Language for Pile NanipuXation and 
Network Job Execution was developed to facilitate user in- 
teraction with the various systems of a network. As 
presently implemented, it enables a user to perform file 
manipulations on four different system types after learning 
only one simple language. In addition, the language pro- 
vides the ability to gain access to a system , to identify a 
user to that system and to easily transfer files between 
systems without learning complicated protocols. 

Work is currently underway to combine the CCL with a 
Networkwide Directory (NWD) to develop the idea of a "net- 
work user." A network user will be connected to the dif- 
ferent systems on the network througn the NAM and be able to 
access the files resident on the different hosts the same 
way a single system user can access files resident on dif- 
fent devices. Address resolution of the files will be done 
through the nam using the NWD and will be transparent to the 
user. Incorporated within this system will be a record level 
access capability for files on remote systems along with fa- 
cilities to control user access to those files. 
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APPeNOZX li Tue conhand languagg 



Connection i:;8tablishing Conunands 

fitiN <IO£MTXfI£H> 
Ibl <IOEMTXFX£K> 
MUM'ICS <XDIi;NTIFI£A> 
MdSXtf <XOeNTXfIfift> 
UNIX45X <XO£NTXFXER> 



File Handling Commands 



APPEND FILfiX FILB2 

COMPARE FX LEX FXLE2 

COPY FXLEX FXLE2 

CREATE PXLE2 

DELETE FXLEl 

ERASE 

LXST 

RENAME 

TXPE 

UNDELETE 



irile Transfer Coofflands 

KETKiifVE FILLl UUbT 
TRANSiTER FILEl tiUi>T 



Connection Termination Conunands 
LEAVE 



Network Job Execution 

Makeprotile Utiltity 
Runmacro Utiltity 
RUN 
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